home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / STUTTGART / SOUND / SOUNDCON00 / !SoundCon_!Help < prev    next >
Encoding:
Text File  |  1995-04-22  |  14.6 KB  |  344 lines
  1.                                   S o u n d C o n
  2.                                  =================
  3.                               version 1.42,  2-04-95
  4.                                   by Rick Hudson
  5.  
  6.  
  7. This software is FreeWare. It must only be distrubuted in its original form.
  8. The PlaySample module is also FreeWare and can be used in other applications
  9. but you must obtain my permission if you wish to distribute it separately
  10. from SoundCon.
  11.  
  12.  
  13.  
  14. Summary
  15. =======
  16.  
  17. SoundCon is an application for basic sound sample format conversion on the
  18. Archimedes. It can read and write samples in a variety of formats common on
  19. various computer platforms and can directly playback most the formats it can
  20. read (without converting it first). An important feature of SoundCon is that
  21. all processing and playback is done from disc meaning that the only memory
  22. required is for the application itself and there is no limit to the sample
  23. size.
  24.  
  25. As of version 1.40 SoundCon can respond to render requests from ArcWeb so
  26. that WWW sounds can be played by just clicking on them.
  27.  
  28.  
  29. Other documentation
  30. ===================
  31.  
  32. The Docs directory within !SoundCon conatins further information on the
  33. PlaySample module and the various sound formats supported. The latter
  34. contains format descriptions, what sub-formats are and aren't supported and
  35. which ones can be played without conversion.
  36.  
  37. Interactive help is supported. Theoretically, you should be able to stop
  38. reading this now and use that.
  39.  
  40.  
  41. Supported formats
  42. =================
  43.  
  44.    Major formats       sub-formats
  45.  
  46.    Audio IFF           8/16 bit, mono/stereo
  47.    Armadeus            n/a
  48.    ARMovie (read only) 8/16 bit, (un)signed linear, VIDC, mono/stereo
  49.    Sun Audio           8 bit µ-law, 8 bit lin, 16 bit lin, mono/stereo
  50.    AudioWorks          8/16 bit (un)signed, µ-law, VIDC, mono/stereo
  51.    IFF/8SVX            n/a
  52.    VOC                 n/a
  53.    Voice modules       4 volume modes, fixed/var frequency, voice/transient
  54.    RIFF WAVE           8/16 bit PCM, µ-law, MS ADPCM, DVI ADPCM, mono/stereo
  55.    Raw data            8/16 bit, (un)signed linear, µ-law, VIDC, mono/stereo
  56.  
  57. For more information on these formats see the file Docs.Formats which
  58. describes in more details what the formats can support and what the menu
  59. sub-options do.
  60.  
  61.  
  62.                                ==============
  63.                                Using SoundCon
  64.                                ==============
  65.  
  66. Loading a sample:
  67. ================
  68.  
  69. SoundCon is sample converter so it can't do anything until you give a
  70. sample. Drag a file onto the icon bar icon or any of it's windows to 'open'
  71. the sample. The settings of the preferences may cause some actions to happen
  72. automatically at this point (see later) but the default is not do anything
  73. except open the sample information window (click select on the icon bar icon
  74. to open it if you need to). This window displays information about the file
  75. loaded. If the format is not recognised (or a recognisable format is
  76. unsupported - WAVEs have several such formats) then an error message is
  77. reported and sample is loaded as raw data.
  78.  
  79.  
  80. Changing the interpretation:
  81. ===========================
  82.  
  83. Recognised formats will not usually have to be fiddled with but raw data
  84. will probably have to have the interpretation of the data changed to make
  85. it sound right - this is largely a trial and error process.
  86.  
  87. At the bottom of the sample info window (click on Toggle Size or scroll
  88. down) there is the interpretation format and frequency - use the pop-up
  89. menus to change these. The format selections are summarised by interactive
  90. help (if your version of RISC OS isn't too old) and described in more detail
  91. in the file docs.Formats.
  92.  
  93. The interpretation frequency set how many sample frames per second to
  94. assume. A sample frame is the samples on all channels at any given point and
  95. so frames per second means samples per channel per second. The menu provides
  96. a list of common frequencies as well as a writable entry for other
  97. frequencies.
  98.  
  99.  
  100. Listening to the sample
  101. =======================
  102.  
  103. The playback control window can be opened by clicking Adjust on the icon bar
  104. icon, clicking Adjust in the sample info window or by selecting the menu
  105. item in the sample info window or icon bar menus. The sample will be played
  106. based on the format and frequency set in the Interpret As section of the
  107. sample info window. An exception to this are samples that cannot be
  108. interpreted as raw data by SoundCon (ADPCM and Audioworks formats) which can
  109. only be played in their original format.
  110.  
  111. The CD-style buttons control the playback and their use should be obvious.
  112. The slider marking the sample progress can be dragged around as an
  113. alternative to setting the sample position with the cue and rewind buttons.
  114.  
  115. The volume slider controls the volume and the speaker button toggles the
  116. speaker on and off (as if that wasn't obvious). If the volume is changed or
  117. the speaker toggled from another application then SoundCon updates the
  118. volume slider and speaker button automatically. Note though that the volume
  119. is independant of the normal system volume so other system-volume
  120. controllers will have no effect.
  121.  
  122. Note that the ADPCM play routines are quite CPU intensive (since they
  123. decompress on the fly) and the sound quality will probably suffer when
  124. interrupts are used heavily (eg lots of disc activity).
  125.  
  126.  
  127. Converting the sample to another format
  128. =======================================
  129.  
  130. Open the conversion window from the info window or icon bar menus. The
  131. current destination format is shown with the usual elements of a save box.
  132. Change the format, sample rate and filename (if current settings are not
  133. suitable) and drag the icon to where you want the new sample to be or click
  134. OK/press Return if a complete path is already present. The conversion
  135. progress window will open and the conversion will occur in the background.
  136. The conversion can be paused if you need the computer to be more responsive
  137. for a while or aborted by clicking the appropriate button.
  138.  
  139. The filename initially present in the convert window will depend on the
  140. preferences (see Preferences for options).
  141.  
  142. The conversion produces a sample (in the specified format) so that playing
  143. it at the speed set in the 'Rate' box will sound the same as the original
  144. sample played at the speed set the 'Frequency' box of the 'Interpret As'
  145. section. That is, the sample is resampled at the new frequency. If the
  146. frequencies are different then new samples are generated by linearly
  147. interpolating between the original samples.
  148.  
  149. See the file Docs.Formats for a description of the supported formats and
  150. their sub formats.
  151.  
  152.  
  153. Preferences
  154. ===========
  155.  
  156. Default Conversion format: This controls what output format will initially
  157. be in the conversion save box when the program is loaded. This format may
  158. also be set on loading a new sample (see Auto Load Actions below). The
  159. effect of these settings is described in 'Converting a sample' above.
  160.  
  161. Interpret Unknown As: When an unrecogised sample is loaded, the data will be
  162. initially interpreted according the settings in this box. The pop-up menus
  163. are identical to those for the Interpret As part of the info window (see
  164. 'Changing The Interpretation' above).
  165.  
  166. Auto Actions On Load: Any combination (including none) of the following
  167. actions are performed when a new sample is opened.
  168.  
  169.   - Open info window: The window displaying the information on the sample is
  170.     opened.
  171.  
  172.   - Open convert window: The conversion/save window is opened.
  173.  
  174.   - Open play window: The play control window is opened.
  175.  
  176.   - Default format: The format and frequency used for the output sample is
  177.     set from the Default Conversion Format part of the preferences.
  178.  
  179.   - Convert: The conversion process is started using the format and filename
  180.     determined from other preference settings.
  181.  
  182.   - Play: The sample is played back.
  183.  
  184. If either convert or play (or both) are selected then the sample is cleared
  185. after their respective operation has completed to allow the next queued
  186. sample to be processed automatically. If convert AND play are selected then
  187. the sample is cleared after both have finished.
  188.  
  189. Sound: This section specifies how to set up the sound system on loading
  190. SoundCon:
  191.  
  192.   - Set volume: If this option is set then the playback volume is set
  193.     according the slider below otherwise it is left unchanged. Note that
  194.     this only affects the volume for the PlaySample module which is
  195.     independant of the normal system volume.
  196.  
  197.   - Don't set speaker: The speaker is left in the current state (on or off).
  198.  
  199.   - Speaker off: The speaker is switched off.
  200.  
  201.   - Speaker on: The speaker is switched on.
  202.  
  203. File naming: These options control what filename will appear in the
  204. conversion/save box when a new sample is opened:
  205.  
  206.   - Do not update name: The writable icon is left the same as when it was
  207.     last used.
  208.  
  209.   - New leaf with previous path: Everything up to the last '.' is preserved
  210.     and remainder (the leaf) is replaced with the leaf name of the source
  211.     sample. This is the only useful file naming option for queue processing.
  212.  
  213.   - New leaf-only name: The filename is set to the leaf name of the source
  214.     sample.
  215.  
  216.   - Add/change extentions: When this option is set an extension of the form
  217.     '/XXX' is appended to the filename (after one is generated from the
  218.     above options). XXX is an MS-DOS like abbreviation like WAV, AIF, RAW
  219.     etc. The leaf is not truncated to 10 characters in case you want to copy
  220.     it to a filing system supporting longer filenames.
  221.     
  222. General: Miscellaneous options
  223.  
  224.   - D-click load: SoundCon repsonds to the Dataload message allowing it to
  225.     load samples by double clicking on them. It attempts to load any file
  226.     that is 'launched'. If it recognises it loads it otherwise it is ignored
  227.     so oher applications still get a look in.
  228.     
  229.   - ArcWeb render: When this option is set, SoundCon responds to rendering
  230.     requests from ArcWeb. If the file to be rendered is a recognised sound
  231.     format and SoundCon is idle then it will be loaded and played.
  232.  
  233. If the auto-convert option and 'New leaf with previous path' is not selected
  234. then a warning is displayed when you exit the preferences window because
  235. queue processing can only be done with that option set. (no update can be
  236. used but all the samples will overwrite each other!)
  237.  
  238.  
  239. Queue processing
  240. ================
  241.  
  242. SoundCon can process a queue of samples as well as single samples; this is
  243. so that a whole bunch of samples can be converted without user intervention.
  244. The restrictions are that all the samples in the batch will be converted to
  245. the same format and will all be placed in the same directory.
  246.  
  247. A sample may be explicitly loaded into the queue by dragging one into the
  248. queue window (opened from the icon bar menu). If more than one sample is
  249. dragged to into SoundCon then the first will be dealt with normally (ie as
  250. if it was a single file) and the rest will be queued automatically.
  251.  
  252. The queue works on the principle that when there is no sample open the one
  253. at the front of the queue is opened (and removed from the queue). The
  254. current sample will be cleared (and the first one queued opened) when:
  255.  
  256.   - You clear it manually from the menu in the Sample Info window.
  257.   - A sample has finished converting and the 'Auto Actions on Load/Convert'
  258.     option is set from the preferences.
  259.   - A sample has finished playing and the 'Auto Actions on Load/Play' option
  260.     is set from the preferences.
  261.     
  262. The last two (auto-clear) instances do not occur if the queue is empty so
  263. that the last sample in the queue remains the current sample.
  264.  
  265. This means all the files in the queue can be converted or played (or both)
  266. automatically.
  267.  
  268. So if SoundCon is set to auto-convert on load, all the files in the queue
  269. will convert automatically. Note however that when the first file is opened
  270. the warning message 'To save, drag the file to a directory display' is
  271. displayed. The first file needs to be dragged manually to determine where to
  272. save the samples. You should also select what you want them all converted
  273. to at this point. A result of this is that conversion can only progress
  274. automatically if the file naming method is set to 'New leaf with previous
  275. path' otherwise the warning will be given for every file or the files will
  276. all have the same name and overwrite each other. If you select auto-convert
  277. and the file naming is set to something inappopriate, you are warned.
  278.  
  279. You will need to change the format and output path (if necessary) before you
  280. load the queue a second time because there will now be suitable defaults to
  281. begin conversion immediately. Alternatively, clear the filename or the entire
  282. sample to set things up after the queue is loaded.
  283.  
  284.  
  285. Using SoundCon with ArcWeb
  286. ==========================
  287.  
  288. From version 1.40 SoundCon can play samples for ArcWeb by responding to its
  289. rendering requests. The 'ArcWeb render' preference must be set and SoundCon
  290. must be idle (ie not converting or playing another sample) to repsond to
  291. ArcWeb requests because it 'loads' the sound as its current sound which would
  292. mean halting any previous activity. While the sound is 'loaded' it can be
  293. converted/saved or played again until a new sound is loaded or it disappears
  294. from the ArcWeb cache.
  295.  
  296.  
  297. History
  298. =======
  299.  
  300. 1.30 - First release
  301.  
  302. 1.40 - Cleaner logarithmic sound conversion
  303.      - Cleaned up glitches on standard-res monitors
  304.      - Added read-only ARMovie format
  305.      - Added ArcWeb sound playing
  306.      - Sun Audio files with zero data length can now be loaded
  307.      - Lowered lower frequency limit after discovering some 5Khz samples
  308.      - First button in preference window now works. (how'd that happen?!)
  309.      - Mouse is now constrained when dragging sliders
  310.      - Doesn't crash if sample disappears between loading and converting
  311.      
  312. 1.41 - Made Arcweb rendering optional
  313.      - Dataload option added to allow loading by double-clicking
  314.      - Made preference window resizable
  315.      
  316. 1.42 - Fixed bug re dragging play slider on 16-bit samples
  317.      - Dragging to playback window when already playing now plays
  318.      - Changing format with 'extensions' on now works
  319.  
  320.  
  321. Problems?
  322. =========
  323.  
  324. I have tried to ensure that SoundCon can process a wide variety of sample
  325. formats and sub-formats and because of this it has been hard to find original
  326. files to test them all with. Please let me know if you encounter a sample
  327. that SoundCon doesn't process correctly; several small bugs have been fixed
  328. between versions 1.30 and 1.40 because of this kind of feedback. I'd also be
  329. interested to hear if there are any other unsupported formats that could be
  330. included in SoundCon's repertoire; bearing in mind that I need some
  331. information about the format before I can implement it.
  332.  
  333.  
  334.  
  335. Thanks to Andrew (adh1003@hermes.cam.ac.uk) for testing and help with the
  336. logarithmic formats.
  337.  
  338. Thanks also to Stewart Brodie (S.N.Brodie@ecs.soton.ac.uk) for suggesting the
  339. ArcWeb addition and supplying the code outline to do it with.
  340.  
  341.  
  342. Rick Hudson,
  343. rick@actrix.gen.nz
  344.